Amazon Connectに、LexボットとLambda関数をCloudFormationや AWS CLIで関連付けしてみた

AWSTemplateFormatVersion: '2010-09-09'
Description: 'Create Lambda, Lex bot, and associate them with Connect instance'

Parameters:
  ConnectInstanceARN:
    Type: String
    Description: The Amazon Resource Name (ARN) of the instance.

Resources:
  MyLambdaFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: test-lambda
      Handler: index.handler
      Role: !GetAtt LambdaExecutionRole.Arn
      Code:
        ZipFile: |
          import json
          def lambda_handler(event, context):
              # TODO implement
              return {
                  'statusCode': 200,
                  'body': json.dumps('Hello from Lambda!')
              }
      Runtime: python3.12

  LambdaExecutionRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: '2012-10-17'
        Statement:
          - Effect: Allow
            Principal:
              Service: lambda.amazonaws.com
            Action: sts:AssumeRole
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

  MyLexBot:
    Type: AWS::Lex::Bot
    Properties:
      Name: test-lex
      DataPrivacy:
        ChildDirected: false
      IdleSessionTTLInSeconds: 300
      RoleArn: !GetAtt LexBotRole.Arn
      BotLocales:
        - LocaleId: ja_JP
          NluConfidenceThreshold: 0.40
          VoiceSettings:
            VoiceId: Kazuha
          Intents:
            - Name: FallbackIntent
              ParentIntentSignature: AMAZON.FallbackIntent
            - Name: yes
              SampleUtterances:
                - Utterance: はい
                - Utterance: そうです

  # IAM role for Lex
  LexBotRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: '2012-10-17'
        Statement:
          - Effect: Allow
            Principal:
              Service: lexv2.amazonaws.com
            Action: sts:AssumeRole
      Policies:
        - PolicyName: lexv2-bot-policy
          PolicyDocument:
            Version: 2012-10-17
            Statement:
              - Effect: Allow
                Action:
                  - polly:SynthesizeSpeech
                Resource: '*'

  # Associate Lex V2 with Connect
  ConnectLexAssociation:
    Type: AWS::Connect::IntegrationAssociation
    Properties:
      InstanceId: !Ref ConnectInstanceARN
      IntegrationType: LEX_BOT
      IntegrationArn: !Sub arn:aws:lex:${AWS::Region}:${AWS::AccountId}:bot-alias/${MyLexBot}/TSTALIASID

  # Associate Lambda with Connect
  ConnectLambdaAssociation:
    Type: AWS::Connect::IntegrationAssociation
    Properties:
      InstanceId: !Ref ConnectInstanceARN
      IntegrationType: LAMBDA_FUNCTION
      IntegrationArn: !GetAtt MyLambdaFunction.Arn

IntegrationArn: !Sub arn:aws:lex:${AWS::Region}:${AWS::AccountId}:bot-alias/${MyLexBot}/TSTALIASID

  MyLexBotAlias:
    Type: AWS::Lex::BotAlias
    Properties:
      BotAliasName: dev
~中略~
  ConnectLexAssociation:
    Type: AWS::Connect::IntegrationAssociation
    Properties:
      InstanceId: !Ref ConnectInstanceARN
      IntegrationType: LEX_BOT
      IntegrationArn: !GetAtt MyLexBotAlias.Arn

$ aws connect associate-lambda-function \
--instance-id <value> \
--function-arn <value>

// コマンド例
$ aws connect associate-lambda-function \
--instance-id arn:aws:connect:ap-northeast-1:123456789012:instance/xxx-xxxx-xxx-xxx \
--function-arn arn:aws:lambda:ap-northeast-1:123456789012:function:test-lambda

$ aws connect associate-bot \
--instance-id <value> \
--lex-v2-bot <value>

// コマンド例 （エイリアスIDは、ABCDEFGHIJ）
$ aws connect associate-bot \
--instance-id arn:aws:connect:ap-northeast-1:123456789012:instance/xxx-xxxx-xxx-xxx \
--lex-v2-bot AliasArn=arn:aws:lex:ap-northeast-1:123456789012:bot-alias/ABCDEFGHIJ/TSTALIASID